home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 34.zip / BS1 part 34 / FredFish PD 302.adf / Selector / Selector.doc < prev    next >
Text File  |  1990-01-15  |  6KB  |  149 lines
  1.  
  2.  
  3.                    Program Selector V2.5  (November 1989)
  4.                    ======================================
  5.  
  6.      This program is freeware, this means that you can copy it freely as long
  7. as you don't ask any more money for it than a nominal fee for copying.  If
  8. you want to distribute this program you should keep this document with it.
  9.      If you have suggestions or remarks about this program, or if you find
  10. any bugs, please let me know.
  11.  
  12.      Program Selector was written to help the user assemble programs on a
  13. boot disk and start them in a userfriendly way.  It can execute any program
  14. that can be started from the CLI.
  15.  
  16.  
  17. USAGE:
  18.  
  19.      Program Selector must be started from CLI:
  20.  
  21.        "1> Selector [-h] [<filename>]"
  22.  
  23.    -h       : When this option is used the two columns will be filled evenly.
  24.    filename : This is the optional filename of the script, if you don't
  25.               specify a name 's:Selector.programs' will be read.
  26.  
  27.  
  28. FILE LIST :
  29.  
  30.     Program Selector will read a script and scan it in the following manner:
  31.  
  32.  L | Description                        |  Example                          |
  33. ---+------------------------------------+-----------------------------------+
  34.  1 | Title (max 32 char)                |  Utilities                        |
  35.  2 | text for 1st gadget (max 37 char)  |  MicroEmacs 1.3                   |
  36.  3 | command sequence (max 128 char)    |  *:c/emacs                        |
  37.  4 | text for 2nd gadget                |  AmigaDOS Ed                      |
  38.  5 | 2nd command sequence               |  *:c/ed                           |
  39.  . | ...                                |  ...                              |
  40.  
  41.     The command sequence consists of any number of commands seperated by ';'.
  42. The following characters all have a special meaning, use them as the first
  43. character of a command:
  44.  
  45.     '*' : Put a '*' in front of the MAIN program if you want to multitask.
  46.           If you don't want to be able to multitask a program don't put a
  47.           '*' in front of the main program. (see RUN mode)
  48.     '#' : When there is a '#' in front of a program it will allways be
  49.           launched, even in EXEC or RUN mode (see later). (Useful for
  50.           programs who need as much memory as possible or don't return to
  51.           the CLI.)
  52.     '!' : The prompt command. The string following the '!' is no command but
  53.           a prompt. A string gadget will appear and prompt you for the
  54.           arguments to be passed to the next command. (The '!' must be the
  55.           command directly in front of the command you want the parameters to
  56.           be passed to.
  57.     '<' : Read new file list. The selector will read the file directly
  58.           following the '<' and will use this to display a new file list.
  59.           (Useful to implement some sort of sub-menus.)
  60.     '@' : If you want to use a subtitle enter a '@' instead of the command
  61.           sequence, the text will appear as a subtitle and can't be
  62.           selected.
  63.  
  64. NOTE : - Include the path to avoid problems, e.g. 'sys:Program' instead of
  65.          'Program'.  Be careful when you use spaces !
  66.  
  67.     Example script:
  68.  
  69.         UTILITIES
  70.         This program is the editor
  71.         !Edit what file ? ;*c:MicroEMACS
  72.         This is a subtitle
  73.         @
  74.         This program doesn't work with fast memory
  75.         c:Run SYS:System/NoFastMem;*:ProgramName
  76.  
  77.  
  78. GADGETS:
  79.  
  80.     There are 22 gadgets for the file text in NTSC and 32 in PAL,
  81. so you can start 22 programs if you've got a NTSC Amiga and 32 with a PAL
  82. Amiga (minus the number of subtitles).
  83.     At the top right are two invisible depth-gadgets so you can depth arrange
  84. the Selector-window.
  85.     The top left contains the RUN-EXEC-LAUNCH gadget. This gadget indicates
  86. whether the programs will be EXECuted (the Selector will disappear and return
  87. after the program has finished), RUN (the program will multitask and you
  88. can keep on using the Selector) or LAUNCHed (the Selector will disappear and
  89. stay away, the startup-sequence will continue after the Selector command).
  90.     You can force a LAUNCH by putting a '#' in front of the main program, no
  91. matter what mode you are in, the program will be LAUNCHed.
  92.  
  93.  
  94. OTHER FUNCTIONS:
  95.  
  96.     At the top right the selector will print the number of free bytes. This
  97. number will constantly update if the selector window is active.
  98.     When you click the right mouse button the Selector window will shrink to
  99. a small window the size of a title-bar. Click the right button again to get
  100. the main window back.
  101.     The small window also contains a close gadget, when you press this the
  102. execution of the startup-sequence will continue after the Selector command.
  103.     The Selector will automatically select PAL or NTSC mode.
  104.  
  105.  
  106. INSTALLATION:
  107.  
  108.     To install Program Selector on your own disk, you must copy these files:
  109.  
  110.         c:Selector         ->  YourDisk:c
  111.         Selector.doc       ->  YourDisk:
  112.         c:More             ->  YourDisk:c
  113.         c:Run              ->  YourDisk:c
  114.  
  115.     Then you must create in YourDisk:s the Selector.programs file. I suggest
  116. you make the two last lines of your file :
  117.  
  118.         About Program Selector
  119.         *:c/More :Selector.doc
  120.  
  121.     The last thing you must do is place the command 'Selector' in your
  122. Startup-Sequence to invoke the Program Selector.
  123.  
  124.  
  125. EXAMPLE:
  126.  
  127.     To try Program Selector out, open a CLI, CD to the directory where the
  128. 'Selector' command and the example scripts are, and type:
  129.  
  130.       "1> Selector Selector.programs"
  131.  
  132.     You'll be presented with a menu from a utility disk, please note that you
  133. won't be able to execute anything, it's only an example script.  To get an
  134. example of a prompt select 'RUN' then 'TrackDisplay'.  Press the right button
  135. followed by the close gadget to quit.
  136.  
  137.  
  138.                             I hope you find this program useful,
  139.  
  140.                                                               Nico.
  141.  
  142.                     Send bug reports, suggestions, etc...
  143.  
  144.                                 Nico François
  145.                                 Corbielaan 13
  146.                                 B-3060 Bertem
  147.                                    BELGIUM
  148.  
  149.